home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1998 November / Freeware November 1998.img / dist / fw_GNUbash.idb / usr / freeware / src / bash-1.14.6 / subst.h.z / subst.h
C/C++ Source or Header  |  1998-01-21  |  8KB  |  182 lines
  1. /* subst.h -- Names of externally visible functions in subst.c. */
  2.  
  3. /* Copyright (C) 1993 Free Software Foundation, Inc.
  4.  
  5.    This file is part of GNU Bash, the Bourne Again SHell.
  6.  
  7.    Bash is free software; you can redistribute it and/or modify it under
  8.    the terms of the GNU General Public License as published by the Free
  9.    Software Foundation; either version 2, or (at your option) any later
  10.    version.
  11.  
  12.    Bash is distributed in the hope that it will be useful, but WITHOUT ANY
  13.    WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14.    FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15.    for more details.
  16.  
  17.    You should have received a copy of the GNU General Public License along
  18.    with Bash; see the file COPYING.  If not, write to the Free Software
  19.    Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
  20.  
  21. #if !defined (_SUBST_H_)
  22. #define _SUBST_H_
  23.  
  24. #include "stdc.h"
  25.  
  26. /* Cons a new string from STRING starting at START and ending at END,
  27.    not including END. */
  28. extern char *substring __P((char *, int, int));
  29.  
  30. /* Remove backslashes which are quoting backquotes from STRING.  Modifies
  31.    STRING, and returns a pointer to it. */
  32. extern char * de_backslash __P((char *));
  33.  
  34. /* Replace instances of \! in a string with !. */
  35. extern void unquote_bang __P((char *));
  36.  
  37. /* Extract the $( construct in STRING, and return a new string.
  38.    Start extracting at (SINDEX) as if we had just seen "$(".
  39.    Make (SINDEX) get the position just after the matching ")". */
  40. extern char *extract_command_subst __P((char *, int *));
  41.  
  42. /* Extract the $[ construct in STRING, and return a new string.
  43.    Start extracting at (SINDEX) as if we had just seen "$[".
  44.    Make (SINDEX) get the position just after the matching "]". */
  45. extern char *extract_arithmetic_subst __P((char *, int *));
  46.  
  47. #if defined (PROCESS_SUBSTITUTION)
  48. /* Extract the <( or >( construct in STRING, and return a new string.
  49.    Start extracting at (SINDEX) as if we had just seen "<(".
  50.    Make (SINDEX) get the position just after the matching ")". */
  51. extern char *extract_process_subst __P((char *, char *, int *));
  52. #endif /* PROCESS_SUBSTITUTION */
  53.  
  54. /* Extract the name of the variable to bind to from the assignment string. */
  55. extern char *assignment_name __P((char *));
  56.  
  57. /* Return a single string of all the words present in LIST, separating
  58.    each word with a space. */
  59. extern char *string_list __P((WORD_LIST *));
  60.  
  61. /* Return a single string of all the words present in LIST, obeying the
  62.    quoting rules for "$*", to wit: (P1003.2, draft 11, 3.5.2) "If the
  63.    expansion [of $*] appears within a double quoted string, it expands
  64.    to a single field with the value of each parameter separated by the
  65.    first character of the IFS variable, or by a <space> if IFS is unset." */
  66. extern char *string_list_dollar_star __P((WORD_LIST *));
  67.  
  68. /* Perform quoted null character removal on each element of LIST.
  69.    This modifies LIST. */
  70. extern void word_list_remove_quoted_nulls __P((WORD_LIST *));
  71.  
  72. /* This performs word splitting and quoted null character removal on
  73.    STRING. */
  74. extern WORD_LIST *list_string __P((char *, char *, int));
  75.  
  76. extern char *get_word_from_string __P((char **, char *, char **));
  77. extern char *strip_trailing_ifs_whitespace __P((char *, char *, int));
  78.  
  79. /* Given STRING, an assignment string, get the value of the right side
  80.    of the `=', and bind it to the left side.  If EXPAND is true, then
  81.    perform parameter expansion, command substitution, and arithmetic
  82.    expansion on the right-hand side.  Perform tilde expansion in any
  83.    case.  Do not perform word splitting on the result of expansion. */
  84. extern int do_assignment __P((char *));
  85. extern int do_assignment_no_expand __P((char *));
  86.  
  87. /* Append SOURCE to TARGET at INDEX.  SIZE is the current amount
  88.    of space allocated to TARGET.  SOURCE can be NULL, in which
  89.    case nothing happens.  Gets rid of SOURCE by free ()ing it.
  90.    Returns TARGET in case the location has changed. */
  91. extern char *sub_append_string __P((char *, char *, int *, int *));
  92.  
  93. /* Append the textual representation of NUMBER to TARGET.
  94.    INDEX and SIZE are as in SUB_APPEND_STRING. */
  95. extern char *sub_append_number __P((int, char *, int *, int *));
  96.  
  97. /* Return the word list that corresponds to `$*'. */
  98. extern WORD_LIST *list_rest_of_args __P((void));
  99.  
  100. /* Make a single large string out of the dollar digit variables,
  101.    and the rest_of_args.  If DOLLAR_STAR is 1, then obey the special
  102.    case of "$*" with respect to IFS. */
  103. extern char *string_rest_of_args __P((int));
  104.  
  105. /* Expand STRING by performing parameter expansion, command substitution,
  106.    and arithmetic expansion.  Dequote the resulting WORD_LIST before
  107.    returning it, but do not perform word splitting.  The call to
  108.    remove_quoted_nulls () is in here because word splitting normally
  109.    takes care of quote removal. */
  110. extern WORD_LIST *expand_string_unsplit __P((char *, int));
  111.  
  112. /* Expand STRING just as if you were expanding a word.  This also returns
  113.    a list of words.  Note that filename globbing is *NOT* done for word
  114.    or string expansion, just when the shell is expanding a command.  This
  115.    does parameter expansion, command substitution, arithmetic expansion,
  116.    and word splitting.  Dequote the resultant WORD_LIST before returning. */
  117. extern WORD_LIST *expand_string __P((char *, int));
  118.  
  119. /* De-quoted quoted characters in STRING. */
  120. extern char *dequote_string __P((char *));
  121.  
  122. /* Expand WORD, performing word splitting on the result.  This does
  123.    parameter expansion, command substitution, arithmetic expansion,
  124.    word splitting, and quote removal. */
  125. extern WORD_LIST *expand_word __P((WORD_DESC *, int));
  126.  
  127. /* Expand WORD, but do not perform word splitting on the result.  This
  128.    does parameter expansion, command substitution, arithmetic expansion,
  129.    and quote removal. */
  130. extern WORD_LIST *expand_word_no_split __P((WORD_DESC *, int));
  131. extern WORD_LIST *expand_word_leave_quoted __P((WORD_DESC *, int));
  132.  
  133. /* Return the value of a positional parameter.  This handles values > 10. */
  134. extern char *get_dollar_var_value __P((int));
  135.  
  136. /* Perform quote removal on STRING.  If QUOTED > 0, assume we are obeying the
  137.    backslash quoting rules for within double quotes. */
  138. extern char *string_quote_removal __P((char *, int));
  139.  
  140. /* Perform quote removal on word WORD.  This allocates and returns a new
  141.    WORD_DESC *. */
  142. extern WORD_DESC *word_quote_removal __P((WORD_DESC *, int));
  143.  
  144. /* Perform quote removal on all words in LIST.  If QUOTED is non-zero,
  145.    the members of the list are treated as if they are surrounded by
  146.    double quotes.  Return a new list, or NULL if LIST is NULL. */
  147. extern WORD_LIST *word_list_quote_removal __P((WORD_LIST *, int));
  148.  
  149. /* This splits a single word into a WORD LIST on $IFS, but only if the word
  150.    is not quoted.  list_string () performs quote removal for us, even if we
  151.    don't do any splitting. */
  152. extern WORD_LIST *word_split __P((WORD_DESC *));
  153.  
  154. /* Take the list of words in LIST and do the various substitutions.  Return
  155.    a new list of words which is the expanded list, and without things like
  156.    variable assignments. */
  157. extern WORD_LIST *expand_words __P((WORD_LIST *));
  158.  
  159. /* Same as expand_words (), but doesn't hack variable or environment
  160.    variables. */
  161. extern WORD_LIST *expand_words_no_vars __P((WORD_LIST *));
  162.  
  163. /* PATHNAME can contain characters prefixed by CTLESC;; this indicates
  164.    that the character is to be quoted.  We quote it here in the style
  165.    that the glob library recognizes.  If CONVERT_QUOTED_NULLS is non-zero,
  166.    we change quoted null strings (pathname[0] == CTLNUL) into empty
  167.    strings (pathname[0] == 0).  If this is called after quote removal
  168.    is performed, CONVERT_QUOTED_NULLS should be 0; if called when quote
  169.    removal has not been done (for example, before attempting to match a
  170.    pattern while executing a case statement), CONVERT_QUOTED_NULLS should
  171.    be 1. */
  172. extern char *quote_string_for_globbing __P((char *, int));
  173.  
  174. /* Call the glob library to do globbing on PATHNAME. */
  175. extern char **shell_glob_filename __P((char *));
  176.  
  177. /* The variable in NAME has just had its state changed.  Check to see if it
  178.    is one of the special ones where something special happens. */
  179. extern void stupidly_hack_special_variables __P((char *));
  180.  
  181. #endif /* !_SUBST_H_ */
  182.